home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / i18n-faq < prev    next >
Encoding:
Text File  |  1995-07-25  |  19.3 KB  |  661 lines
  1. Subject: bit.international.software FAQ
  2. Newsgroups: bit.software.international,news.answers
  3. From: jbowyer@cis.vutbr.cz (Bowyer Jeff)
  4. Date: Wed, 14 Jul 1993 19:19:30 GMT
  5.  
  6. Archive-name: i18n-faq
  7. Last-modified: 1993/07/12
  8.  
  9.  
  10.                    INSOFT-L
  11.  
  12.        The Internationalization of Software Mailing List
  13.  
  14.            Frequently Asked Questions (FAQ)
  15.  
  16.  
  17.                    June 1993
  18.  
  19. ----------------------------------------------------------------------
  20.  
  21.                  Introduction
  22.  
  23.  
  24. If you have any suggested enhancements for this document, please
  25. send an electronic mail message to insoft-l-request@cis.vutbr.cz.
  26.  
  27. The author of this document is not responsible for the accuracy of
  28. the information that it contains.  Instead, he depends on readers
  29. of this document to provide up-to-date information.
  30.  
  31. ----------------------------------------------------------------------
  32.  
  33.                Table of Contents
  34.  
  35.  
  36. An * before a question indicates either
  37.  
  38.    1. The question is new;
  39.    2. The answer associated with the question has been updated;
  40.    3. The anonymous ftp file described in the answer has been updated.
  41.  
  42.  
  43. Administrivia
  44. =============
  45.  
  46.      A01      What is the purpose of the INSOFT-L mailing list?
  47.      A02      Is INSOFT-L a moderated mailing list?
  48.      A03      How do I subscribe to INSOFT-L?
  49.      A04      Who owns the INSOFT-L mailing list?
  50.      A05      If I have an administrative problem with the INSOFT-L
  51.               mailing list, whom do I contact?
  52.      A06      Does INSOFT-L have an associated anonymous ftp server?
  53.      A07      Does INSOFT-L have an associated mail server?
  54.      A08      Where can I obtain the Frequently Asked Questions (FAQ)
  55.               for INSOFT-L?
  56.      A09      How can I obtain an archive file of messages previously
  57.               distributed to the INSOFT-L mailing list?
  58.      A10      Does INSOFT-L have a gateway to network news?
  59.  
  60. Documentation
  61. =============
  62.  
  63. *    D01      Where can I obtain a list of publications related to
  64.               the internationalization of software?
  65.  
  66. Internationalization
  67. ====================
  68.  
  69.      I01      Where can I obtain a list of tools for internationalizing
  70.               software?
  71.      I02      Where can I obtain a list of internationalized software
  72.               products?
  73. *    I03      Where can I obtain a list of organizations related to
  74.               internationalization?
  75.  
  76. Jargon
  77. ======
  78.  
  79.      J01      What is e13n?
  80.      J02      What is i18n?
  81.      J03      What is j10n?
  82.      J04      What is l10n?
  83.      J05      What is NLS?
  84. *    J06      What is XPG4?
  85.  
  86. Localization
  87. ============
  88.  
  89. *    L01      Where can I obtain a list of tools for localizing
  90.               software?
  91. *    L02      Where can I obtain a list of fonts for localizing software?
  92.      L03      Where can I obtain a list of localized software
  93.               products?
  94. *    L04      Where can I obtain a list of anonymous ftp sites that
  95.               specialize in localized software?
  96. *    L05      Where can I obtain information about localizing for
  97.               Japanese?
  98.  
  99. Techniques for Internationalization/Localization
  100. ================================================
  101.  
  102.      T01      How do I determine the date and time formats for
  103.               a country?
  104.      T02      How can I determine a user's international preferences?
  105.      T03      Should shortcut keys be translated?
  106.      T04      What UNIX programs and functions exist for
  107.               internationalizing/localizing a program?
  108.      T05      How should UNIX be configured to allow the user to read
  109.               a man page in a preferred language?
  110.      T06      How should UNIX man page directories be organized to
  111.               support multiple languages?
  112.      T07      Do standardized codes exist for specifying a language?
  113. *    T08      Should abend messages be translated?
  114. *    T09      How can I type foreign characters into X-Windows?
  115.      T10      Do users prefer a program with an English interface
  116.               or with their national language interface?
  117. *    T11      What paper sizes are used internationally?
  118.     
  119.  
  120. ----------------------------------------------------------------------
  121.  
  122.                  Administrivia
  123.                  =============
  124.  
  125.                              
  126. A01      What is the purpose of the INSOFT-L mailing list?
  127.  
  128.  
  129.    INSOFT-L on LISTSERV@CIS.VUTBR.CZ   Internationalization of Software
  130.                                        Discussion List
  131.  
  132.    Internationalization of software relates to two subjects:
  133.  
  134.         1. Software that is written so a user can easily change the
  135.            language of the interface;
  136.  
  137.         2. Versions of software, such as Czech WordPerfect, whose
  138.            interface language differs from the original product.
  139.  
  140.    Topics discussed on this list include:
  141.  
  142.         -- Techniques for developing new software
  143.  
  144.         -- Techniques for converting existing software
  145.  
  146.         -- Internationalization tools
  147.  
  148.         -- Announcements of internationalized public domain software
  149.  
  150.         -- Announcements of foreign-language versions of commercial
  151.            software
  152.  
  153.         -- Calls for papers
  154.  
  155.     -- Conference announcements
  156.  
  157.     -- References to documentation related to the
  158.            internationalization of software
  159.  
  160.  
  161. A02      Is INSOFT-L a moderated mailing list?
  162.  
  163.    INSOFT-L is moderated.
  164.  
  165.  
  166. A03      How do I subscribe to INSOFT-L?
  167.  
  168.    To subscribe to INSOFT-L, send an electronic mail message to
  169.    listserv@cis.vutbr.cz with the body containing the command:
  170.  
  171.       SUB INSOFT-L Yourfirstname Yourlastname
  172.  
  173.  
  174. A04      Who owns the INSOFT-L mailing list?
  175.  
  176.    Center for Computing and Information Services
  177.    Technical University of Brno
  178.    Udolni 19, 602 00 BRNO
  179.    Czech Republic
  180.  
  181.  
  182. A05      If I have an administrative problem with the INSOFT-L
  183.          mailing list, whom do I contact?
  184.  
  185.    To determine which commands the listserver software that manages
  186.    INSOFT-L can process, send an electronic mail message to
  187.    listserv@cis.vutbr.cz with the body containing the command:
  188.  
  189.       help
  190.  
  191.    If you perform functions such as subscribe and unsubscribe through the
  192.    appropriate listserver command, you free INSOFT-L's list manager for
  193.    other tasks.
  194.  
  195.    However, when you need administrative assistance that the listserver
  196.    software cannot handle, please send an electronic mail message to
  197.    insoft-l-request@cis.vutbr.cz
  198.  
  199.  
  200. A06      Does INSOFT-L have an associated anonymous ftp server?
  201.  
  202.    rhino.cis.vutbr.cz (147.229.3.10)
  203.  
  204.    The upper-level directory for INSOFT-L files is pub/lists/insoft-l.
  205.  
  206.    The file "master-index" in pub/lists/insoft-l contains a listing of
  207.    all available files.  Every directory contains a file named 00README,
  208.    which describes all subdirectories and files in that directory.
  209.  
  210.  
  211. A07      Does INSOFT-L have an associated mail server?
  212.  
  213.    For INSOFT-L subscribers who do not have a direct Internet connection,
  214.    you can get any files that are stored on our anonymous ftp server by
  215.    sending a mail message request.
  216.  
  217.    For more information, send a mail message to
  218.  
  219.       mailserv@cis.vutbr.cs
  220.  
  221.    The body of your mail message should only include the command
  222.  
  223.       help
  224.  
  225.    Notes:
  226.  
  227.       1. This mail server is home grown.  It uses a program named
  228.          "deliver" to intercept mail messages sent to
  229.          mailserv@cis.vutbr.cs, but I coded all of the command
  230.      processing.  If you find any bugs (who me?) or want to
  231.      suggest any enhancements (it's very rudimentary, but it
  232.      works), please send your comments directly to me:
  233.  
  234.         jbowyer@cis.vutbr.cs
  235.  
  236.       2. The mail server program depends on a good address in the
  237.      From: header of your mail message.  Before you use the mail
  238.      server, please make sure that the From: header in your mail
  239.      message contains a good address (i.e. a full Internet, BITNET,
  240.      or Usenet address)
  241.  
  242.  
  243. A08      Where can I obtain the Frequently Asked Questions (FAQ)
  244.          for INSOFT-L?
  245.  
  246.    Anonymous FTP
  247.  
  248.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  249.       Directory: pub/lists/insoft-l
  250.       File:      faq
  251.  
  252.    Network News
  253.  
  254.       news.answers
  255.  
  256.    INSOFT-L's list manager will notify the list whenever an updated FAQ
  257.    becomes available.
  258.  
  259.  
  260. A09      How can I obtain an archive file of messages previously
  261.          distributed to the INSOFT-L mailing list?
  262.  
  263.          An archive file will be created on the first day of each month,
  264.      and it will contain all messages distributed on INSOFT-L
  265.      during the previous month.
  266.  
  267.          There are two ways to obtain an archive file:
  268.  
  269.               1) Use anonymous ftp to connect to rhino.cis.vutbr.cs.
  270.                  The archive files for INSOFT-L will be stored in the
  271.                  directory
  272.  
  273.                       pub/lists/insoft-l/archive
  274.  
  275.     
  276.               2) You can obtain an index of all available archive files
  277.                  by sending an email message to listserv@cis.vutbr.cs
  278.                  (Note: please do not send the email message to
  279.                  insoft-l@cis.vutbr.cs).  The body of your message
  280.                  should only contain the command:
  281.  
  282.                       index insoft-l
  283.  
  284.                  After you review the index, you can request a specific
  285.                  archive by sending an email message to
  286.                  listserv@cis.vutbr.cs (Note: please do not send the
  287.                  email message to insoft-l@cis.vutbr.cs).  The body of
  288.                  your message should only contain the command:
  289.  
  290.                       get insoft-l name_of_archive_file
  291.  
  292.                  The listserver software will email the archive file to
  293.          you.
  294.  
  295.  
  296. A10      Does INSOFT-L have a gateway to network news?
  297.  
  298.          The name of INSOFT-L's gateway to network news is
  299.          bit.software.international.
  300.  
  301.          This gateway is bi-directional, meaning:
  302.  
  303.             1. If someone posts a message on bit.software.international,
  304.                subscribers to the INSOFT-L mailing list will receive a copy;
  305.  
  306.             2. If an INSOFT-L subscriber submits a message to the mailing
  307.            list, a copy will be posted to bit.software.international
  308.  
  309. ----------------------------------------------------------------------
  310.  
  311.                  Documentation
  312.                  =============
  313.  
  314.                              
  315. D01      Where can I obtain a list of publications related to
  316.          the internationalization of software?
  317.  
  318.    Anonymous FTP
  319.  
  320.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  321.       Directory: pub/lists/insoft-l/doc
  322.       File:      publications
  323.  
  324. ----------------------------------------------------------------------
  325.  
  326.              Internationalization
  327.              ====================
  328.  
  329.                              
  330. I01      Where can I obtain a list of tools for internationalizing
  331.          software?
  332.  
  333.    Anonymous FTP
  334.  
  335.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  336.       Directory: pub/lists/insoft-l/doc/products
  337.       File:      internationalization.tools
  338.  
  339.  
  340. I02      Where can I obtain a list of internationalized software
  341.          products?
  342.  
  343.    Anonymous FTP
  344.  
  345.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  346.       Directory: pub/lists/insoft-l/doc/products
  347.       File:      internationalized
  348.  
  349.  
  350. I03      Where can I obtain a list of organizations related to
  351.          internationalization?
  352.  
  353.    Anonymous FTP
  354.  
  355.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  356.       Directory: pub/lists/insoft-l/doc
  357.       File:      organizations
  358.  
  359. ----------------------------------------------------------------------
  360.  
  361.                 Jargon
  362.                 ======
  363.  
  364.  
  365. J01      What is e13n?
  366.  
  367.          e13n stands for "europeanization" (count the letters
  368.      between e and n).
  369.  
  370.     
  371. J02      What is i18n?
  372.  
  373.          i18n stands for "internationalization" (count the letters
  374.      between i and n).
  375.  
  376.     
  377. J03      What is j10n?
  378.  
  379.          j10n stands for "japanization" (count the letters
  380.      between j and n).
  381.  
  382.     
  383. J04      What is l10n?
  384.  
  385.          l10n stands for "localization" (count the letters
  386.      between l and n).
  387.  
  388.     
  389. J05      What is NLS?
  390.  
  391.          "National Language Support" . . . the ability of a software
  392.      program to handle more than one dialogue language
  393.  
  394.  
  395. J06      What is XPG4?
  396.  
  397.          Version 4 of the _X/Open Portability Guide_
  398.     
  399. ----------------------------------------------------------------------
  400.  
  401.                  Localization
  402.                  ============
  403.  
  404.                              
  405. L01      Where can I obtain a list of tools for localizing
  406.          software?
  407.  
  408.    Anonymous FTP
  409.  
  410.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  411.       Directory: pub/lists/insoft-l/doc/products
  412.       File:      localization.tools
  413.  
  414.  
  415. L02      Where can I obtain a list of fonts for localizing software?
  416.  
  417.    Anonymous FTP
  418.  
  419.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  420.       Directory: pub/lists/insoft-l/doc/products
  421.       File:      fonts
  422.  
  423.  
  424. L03      Where can I obtain a list of localized software
  425.          products?
  426.  
  427.    Anonymous FTP
  428.  
  429.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  430.       Directory: pub/lists/insoft-l/doc/products
  431.       File:      localized
  432.  
  433.    In addition, major software companies will have their localized
  434.    products listed in a separate file.  For example, a list of
  435.    Microsoft's products is available:
  436.  
  437.       Anonymous FTP
  438.  
  439.          Site:      rhino.cis.vutbr.cz (147.229.3.10)
  440.          Directory: pub/lists/insoft-l/doc/products
  441.          File:      microsoft.txt
  442.  
  443.  
  444. L04      Where can I obtain a list of anonymous ftp sites that
  445.          specialize in localized software?
  446.  
  447.    Anonymous FTP
  448.  
  449.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  450.       Directory: pub/lists/insoft-l/doc
  451.       File:      localized.ftp.sites
  452.  
  453.  
  454. L05      Where can I obtain information about localizing for
  455.          Japanese?
  456.  
  457.    Anonymous FTP
  458.  
  459.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  460.       Directory: pub/lists/insoft-l/doc/japanese
  461.  
  462. ----------------------------------------------------------------------
  463.  
  464.        Techniques for Internationalization/Localization
  465.        ================================================
  466.  
  467.  
  468. T01      How do I determine the date and time formats for
  469.          a country?
  470.  
  471.          MS-DOS
  472.  
  473.         See page 395 of the English MS-DOS 5 user's guide
  474.  
  475.  
  476. T02      How can I determine a user's international preferences?
  477.  
  478.          MS-DOS
  479.  
  480.         Use interrupt 21h with the ah register set to 65h.  This
  481.         interrupt returns extended country information.
  482.     
  483.          Microsoft Windows
  484.  
  485.             In Microsoft Windows, it is relatively easy to have your
  486.         program use the GetProfileString API function to obtain the
  487.         user's international preferences from the WIN.INI file.
  488.         The following example shows various international settings
  489.         from WIN.INI that should be taken into account:
  490.  
  491.                [intl]
  492.                sLanguage=enu
  493.                sCountry=United States
  494.                iCountry=1
  495.                iDate=0
  496.                iTime=0
  497.                iTLZero=0
  498.                iCurrency=0
  499.                iCurrDigits=2
  500.                iNegCurr=0
  501.                iLzero=1
  502.                iDigits=2
  503.                iMeasure=1
  504.                s1159=AM
  505.                s2359=PM
  506.                sCurrency=$
  507.                sThousand=,
  508.                sDecimal=.
  509.                sDate=/
  510.                sTime=:
  511.                sList=,
  512.                sShortDate=M/d/yy
  513.                sLongDate=dddd, MMMM dd, yyyy
  514.  
  515.          UNIX
  516.  
  517.             Use the LC_LOCALE environment variable.
  518.  
  519.         In System V.3/V.4, use the LANG environment variable to
  520.         determine the language and the NLSPATH environment variable to
  521.         determine the directory path to message catalogues.
  522.  
  523.          [Note: A program could override these default values with a
  524.             command-line parameter.]
  525.         
  526.  
  527. T03      Should shortcut keys be translated?
  528.  
  529.    Allow the user three choices:
  530.  
  531.       1. A set of shortcut keys for the language used;
  532.       2. A set of shortcut keys that retains the original language
  533.          conventions;
  534.       3. Allow the user to establish a personal set of shortcut keys.
  535.  
  536.    Some software producers, however, mandate that the shortcut keys not
  537.    be changed in a localized version.
  538.  
  539.  
  540. T04      What UNIX programs and functions exist for
  541.          internationalizing/localizing a program?
  542.  
  543.          [Note: Not all of the listed programs and functions are available
  544.             on all UNIX systems.]
  545.         
  546.          Programs
  547.  
  548.         gencat      to generate a formatted message catalogue
  549.         mkstr       to create a file containing messages extracted
  550.                         from C source code
  551.         msgfmt      to create a message object file from a portable
  552.                     message file
  553.         xmodmap     to remap the keyboard
  554.  
  555.          Functions
  556.  
  557.         catopen     to open a message catalogue
  558.         catclose    to close a message catalogue
  559.         catgets     to read a message from a message catalogue
  560.         catgetmsg   to read a message from a message catalogue
  561.                     (superseded by catgets)
  562.  
  563.  
  564. T05      How should UNIX be configured to allow the user to read
  565.          a man page in a preferred language?
  566.  
  567.      Use the MANPATH environment variable.
  568.  
  569.  
  570. T06      How should UNIX man page directories be organized to
  571.          support multiple languages?
  572.  
  573.          Put the man pages for each language in a separate directory
  574.      hierarchy.  For example, French man pages could be stored in
  575.      /usr/man/French/man1, /usr/man/French/man2, etc.
  576.  
  577.  
  578. T07      Do standardized codes exist for specifying a language?
  579.  
  580.          ISO
  581.  
  582.         ISO 639:1988 uses two-letter language codes.  For example,
  583.         "ga" is the code for Irish Gaelic.
  584.     
  585.          MS-DOS
  586.  
  587.         WordPerfect uses two-letter codes.  For example, "GA" is the
  588.         code for Scottish Gaelic.
  589.     
  590.          Microsoft Windows
  591.     
  592.             Microsoft Word for Windows uses the name of the language in its
  593.             own language.  For example, the code for Swedish is "Svenska".
  594.  
  595.  
  596. T08      Should abend messages be translated?
  597.  
  598.          Can the user fix the problem?
  599.            Then tell him what it is in his language.
  600.  
  601.          Will the problem end up being referred back
  602.          to headquarters' customer support, qa or development?
  603.            Then keep the error message in English, you'll only
  604.            lose meaning in round-trip translating.
  605.  
  606.          Are you in a desperate hurry, or have you already
  607.          gone over budget?
  608.            Then focus on getting the major part of the user interface,
  609.            where the user spends 95% of his time, perfect.  Take the
  610.            gamble that obscure error messages will never be triggered.
  611.            If anyone cares passionately enough to complain, translate
  612.            the messages for the next release.
  613.  
  614.          We often precede the actual error message in English with the
  615.          word "Error" in the local language.
  616.  
  617.          Althea Bertrand (althea@cicero.hq.ileaf.com)
  618.          Interleaf, Inc.
  619.  
  620.  
  621.          Include a header in the user's language informing
  622.          him/her that this is an obscure error, some advice as to
  623.          what to do (whom to call?) and that technical information
  624.          will follow (which can then be in ~any~ language).
  625.  
  626.          Nils-Erik Gustafsson (euaneg@eua.ericsson.se)
  627.  
  628.  
  629.          See INSOFT-L's jun1993 archive for several answers to this
  630.      question.
  631.  
  632.  
  633. T09      How can I type foreign characters into X-Windows?
  634.  
  635.          Use xmodmap(1X)
  636.  
  637.  
  638. T10      Do users prefer a program with an English interface
  639.          or with their national language interface?
  640.  
  641.          Most users would prefer an interface with their national
  642.      language.  In fact, in some countries (e.g. France), there may
  643.      exist a strong cultural bias against foreign languages.
  644.  
  645.      Perhaps the best solution is to provide users with a choice.
  646.      They can specify a preferred language through an environment
  647.      variable or in an initialization file, but switch to a
  648.      different interface while running the program.
  649.  
  650.      (See FAQ question T02)
  651.  
  652.  
  653. T11      What paper sizes are used internationally?
  654.  
  655.    Anonymous FTP
  656.  
  657.       Site:      rhino.cis.vutbr.cz (147.229.3.10)
  658.       Directory: pub/lists/insoft-l/doc/standards
  659.       File:      paper.txt
  660.  
  661.